NVDA Community Addons/ addons/ Add-on Updater  (46%)

Add-on Updater

  • Autori: Joseph Lee, Luke Davis
  • Scarica la versione stabile
  • NVDA compatibility: 2023.1-2024.2+
  • This is a would-be legacy add-on: NVDA 2023.2 includes add-on update check functionality through add-on store

Questo componente aggiuntivo controlla eventuali aggiornamenti degli add-on installati, li scarica e li installa. Si tratta del tentativo di soddisfare il ticket 3208 presente nel repository di NVDA.

To check for updates after installing this add-on, go to NVDA menu/Tools/Check for add-on updates (if NVDA did notice updates, the menu item will say "Review add-on updates" followed by update count). If updates are available, a list of add-on updates will be shown, with each entry consisting of add-on name, current version, new version, and update channel. Select Update, and NVDA will download and apply updates in sequence, with a prompt to restart your NVDA shown afterwards.

Esistono alcuni componenti aggiuntivi che sono in grado di aggiornarsi autonomamente e che, pertanto, non saranno presi in esame da questo add-on. Essi sono (n.d.t.: elenco non esaustivo):

  • Braille Extender
  • Bottega dei componenti aggiuntivi (Store spagnolo degli addon, Tienda in originale)

Note importanti:

  • Once the relevant feature is included in NVDA in the form of an add-on store with automatic updates and update notification, this add-on will be phased out. Currently, while the Add-on Store was introduced in NVDA 2023.2, and basic update notifications will be available in NVDA 2024.3, the full range of capabilities are not yet available.
  • This add-on requires Windows 10 Version 22H2 or later.
  • This add-on is not intended to be used in secure screens. If you have add-ons installed in the secure screen, even if you copy Add-on Updater to secure screen mode, Add-on Updater will not work.
  • Se i nuovi aggiornamenti degli add-on specificano un intervallo di compatibilità (versione minima e ultima versione testata di NVDA), e se la versione dello screen reader in uso non è compresa tra di esse, non verrà eseguito alcun aggiornamento.
  • Not all add-ons come with development releases. If you are not getting updates after choosing to install development versions of an add-on, switch to stable channel for affected add-ons.
  • In the NVDA settings window, while editing the settings for Add-on Updater, you may notice that the title indicates that you are editing settings for a particular configuration profile (whatever profile you had active before entering settings). This does not matter. This add-on's settings are always global.
  • Su alcuni sistemi (in particolare i computer aggiunti a un dominio aziendale), la funzionalità di controllo degli aggiornamenti dei componenti aggiuntivi potrebbe non funzionare correttamente, pertanto gli aggiornamenti dei componenti aggiuntivi devono essere scaricati manualmente.
  • Some features require NVDA to be installed on the computer.
  • Some add-on releases include SHA256 hash values for checking add-on package integrity (all add-ons published on add-on store include SHA256 values), and if the hash value does not match, add-on updating will fail.

Impostazioni del componente aggiuntivo

You can configure Add-on Updater settings from NVDA Settings screen (NVDA menu, Preferences, Settings) under Add-on Updater category. Add-on settings are as follow:

  • Automatically check for add-on updates: if checked, NVDA will check for add-on updates once every 12 hours. Automatic update checks are enabled by default on Windows client systems, and disabled by default on server systems.
  • Add-on update notification: you can choose to receive update notification as a dialog or a toast. On server systems or running a portable copy of NVDA, update notification will be shown as a dialog.
  • Update add-ons in the background (update notification is set to toast): if checked, Add-on Updater will apply updates in the background. A toast will appear informing you that add-on updates are being downloaded and installed, followed by another message announcing update results. Same limitations as add-on update notification setting and toast must be selected from the above option in order for background updates to work.
  • Do not update add-ons: you can choose add-ons that should not be updated.
  • Prefer development releases: any add-ons checked in this list will receive development (prerelease) releases.
  • Development release channel (selected add-on must be checked from prefer development releases): allows selecting development updates coming from either dev or beta channel.
  • Add-on update source: you can choose where to get updates from. Currently Add-on Updater supports downloading updates from the sources listed below. A confirmation message will be shown after changing update source.

Le fonti di aggiornamento dei componenti aggiuntivi disponibili sono:

  • NV Access add-on store (default)
  • Community add-ons website
  • Catalogo dei componenti aggiuntivi della comunità spagnola
  • Cataloghi gestiti dalle comunità NVDA in Cina e Taiwan

Version 24.3/24.08

  • When NVDA starts, Add-on Updater will not present updates dialog if NVDA 2024.3 or later is in use and update notifications is set to "notify" from NVDA's add-on store settings.

Version 24.2.4

  • Fix a bug related to the fix in version 24.2.1: that bug was not fully fixed in NVDA 2023.X, because the fix relied on a change made in NVDA 2024.1. This situation is now detected and patched (josephsl/addonUpdater#22).
  • The update interval has been changed to 12 hours.
  • The readme now makes note of the update notifications available natively in NVDA 2024.3.
  • The readme has been updated to comment on an unfixable, but harmless, bug in NVDA's settings panel (josephsl/addonUpdater#8).

Version 24.2.2

  • Lower update interval to six hours.

Version 24.2.1

  • Fixes a problem wherein Updater's updates, which appear in the external channel, were shown as still updatable in the store via the stable (or other) channel. Caused by residual JSON files from old non-external installations. Now they are removed.

Version 24.2.0

  • Release compatible with NVDA 2024.1.

Version 24.01.1

  • Short life-span release which removes the legacy status introduced in late

Version 23.10

  • Changed update notification message to mention NV Access add-on store if running NVDA 2023.2 or later and add-on update source is set to add-on store.

Version 23.09

  • Windows 10 Version 22H2 or later is required.

Version 23.08

This is the final version to support Windows 7, 8, 8.1, and 10 21H2 and earlier.

  • Add-on update results dialog or toast message will be shown once add-on store message is closed.
  • If add-on updates dialog is shown and then closed without installing add-ons, NVDA will no longer report no add-on updates when add-on updates are checked.
  • Add-on Updater will no longer present startup messages and perform update checks if updating a portable copy of NVDA.

Version 23.07

  • If using an NVDA release with add-on store included, a startup message will be shown informing users about the new add-on store. If this happens, add-on update results dialog will not be shown. Add-on Updater will continue to work.
  • Improved performance when checking for add-on updates from NV Access add-on store and community add-ons website update sources, particularly when no add-on updates are available.

Version 23.06

  • NVDA 2023.1 or later is required.
  • Changed default add-on update source from community add-ons website to NV Access add-on store.

Version 23.05

  • Add-on update channel will be displayed when reviewing available add-on updates.
  • NVDA will present a message about add-on store if using NVDA releases with add-on store included.

Version 23.04

  • Added development update channel setting to let users of development add-ons choose between dev and beta update channels. This option is shown if the selected add-on from prefer development releases list is checked.
  • NV Access add-on store is broadly available as an update source from Add-on Updater.

Version 23.03

  • Due to changes made to the website used by some update sources, this must be installed manually.
  • Added NV Access add-on store as an experimental add-on update source.

Versione 23.02

  • E' richiesto NVDA 2022.4 o versioni successive.
  • NVDA will no longer offer what appears to be older add-on updates for most add-ons after checking for add-on updates. This applies to add-ons with version text of the form number.number.

Versione 23.01

  • NVDA will check minimum Windows version for add-on updates if update source is set to NVDA community add-ons website.
  • Improved performance when downloading many ad-on updates at once. As a result, the order of add-on downloads shown in download progress dialog will be random.
  • Parts of the add-on now use Python's concurrent.futures module to improve performance, specifically update check and download processes.

Versione 22.11

  • E' richiesto NVDA 2022.3 o versioni successive.

Versione 22.10

  • Added catalogs from NVDA communities in China and Taiwan as add-on update sources (by Woody Tseng).

Versione 22.09

  • E' richiesto NVDA 2022.2 o versioni successive.
  • NVDA will check SHA256 hash values while downloading add-on updates if the add-on update source includes hash values for add-on packages. If hash value is invalid, add-on updating will fail.

Versione 22.08

  • Significant internal code reorganization and rewrites.
  • On Windows Server systems, automatic add-on update check feature is disabled by default (affects new installations).
  • Added ability to select different add-on update sources. Add-on Updater can check for updates hosted on community add-ons website (addons.nvda-project.org) or Spanish community add-ons catalog (nvda.es). A new combo box was added in add-on settings panel to select add-on update source.
  • On Windows 10 and later, it is possible to let Add-on Updater check for, download, and install add-on updates in the background provided that NVDA is actually installed and ad-on update notification is set to toast.
  • Redesigned add-on update download and install experience for multiple add-on updates, including use of a single dialog to show download progress for all add-ons and updating add-ons after downloading all of them.
  • If NVDA is set to announce update notifications as toasts, "check for add-on updates" menu item will become "review add-on updates" when updates become available, with the new name including add-on update count.
  • In NVDA 2022.1 and later, Add-on Updater can process command-line switches for this add-on (currently none).
  • In add-on updates dialog, add-ons disabled by the user are unchecked by default, and a confirmation message will be shown checking disabled add-ons and attempting to update them as doing so will enable them.

Versione 22.07

  • URL's used by the add-on are now constants hosted inside a new module (contributed by Luke Davis).
  • Add-on download progress dialog is now centered on screen.

Versione 22.03

  • Improved security by not loading the add-on when NVDA is running in secure mode.

Versione 22.02

  • E' richiesto NVDA 2021.3 o versioni successive.
  • On Windows 10, add-on update toast notifications are localized.

Versione 22.01

  • E' richiesto NVDA 2021.2 o versioni successive.
  • On server systems running Windows Server 2016 and later, add-on updates will be presented in a dialog instead of using toast notifications.

Versione 21.10

  • It is again possible to check for add-on updates on some systems, notably after a clean Windows installation.

Versione 21.09

  • E' richiesto NVDA 2021.1 o versioni successive.
  • on Windows 10 and later, it is possible to select add-on update notification between a toast message and an update dialog. This can be configured from Add-on Updater settings found in NVDA Settings screen.
  • Add-on Updater will no longer check minimum Windows release information for add-ons as add-ons such as Windows App Essentials provide better Windows compatibility information.

Versione 21.07

  • On Windows 10 and later, a toast notification will be shown when add-on updates are available. Note that you cannot click this notification - you must open NVDA menu/Tools/Check for add-on updates to review updates.
  • When legacy add-ons dialog is shown at startup, you can now review legacy add-ons and reasons just like add-on updates.
  • Improved add-on update check internals, including use of add-on metadata collection provided by the community to validate add-on compatibility. Among other things, this eliminates add-on releases for adding update checks for new add-ons.

Versione 21.05

  • NVDA will no longer play error tones if trying to check updates while using NVDA 2021.1 alpha snapshots, caused by changes to wxPython GUI toolkit.

Versione 21.03

  • E' richiesto NVDA 2020.4 o versioni successive.
  • NVDA will present an error dialog if errors occur while checking for add-on updates such as loss of Internet connection.

Versione20.11

  • E' richiesto NVDA 2020.3 o versioni successive.
  • Risolti molti problemi legati allo stile del codice e bug potenziali con Flake8.
  • NVDA will no longer play error tones or appear to do nothing when using the add-on while NVDA is running from source code. A message about this fact will be recorded in the log instead.

Novità nella versione 20.07

  • E' richiesto NVDA 2020.1 o versioni successive.
  • Se sono installati uno o più add-on obsoleti (come Screen Curtain), Add-on Updater presenterà un messaggio che vi chiederà di disabilitare o disinstallare questi add-on.
  • E' ora possibile salvare, ricaricare o riavviare le impostazioni di Add-on Updater premendo Control+NVDA+C, Control+NVDA+R una volta o Control+NVDA+R tre volte, respettivamente.

Novità nella versione 20.06

  • Risolti molti problemi legati allo stile del codice e bug potenziali con Flake8.

Novità nella versione 20.04

  • NVDA non sembrerà più bloccato e non emetterà segnali acustici di errore quando si cercherà di aggiornare degli add-on tramite Add-on Updater.
  • Risolto un problema per cui l'elemento "controlla aggiornamenti dei componenti aggiuntivi" non era presente nel menu Strumenti di NVDA.

Novità nella versione 20.03

  • E' richiesto NVDA 2019.3 o versioni successive.
  • Quando si installeranno aggiornamenti dei componenti aggiuntivi, Add-on Updater non controllerà più l'intervallo di compatibilità. Sarà NVDA ad effettuare questo controllo.

Novità nella versione 19.11

  • Quando sono disponibili aggiornamenti di componenti aggiuntivi, NVDA dirà quanti ve ne sono.

Novità nella versione 19.09

  • Richiede NVDA 2019.2 o versioni successive.
  • Sono stati risolti errori di timeout che si verificavano per lo più durante lo scaricamento di file provenienti da Jithub.

Novità nella versione 19.04

  • Richiede NVDA 2019.1 o versioni successive.
  • Quando si installano gli aggiornamenti dei componenti aggiuntivi, verranno verificate sia la versione minima che l'ultima testata di NVDA.

Novità nella versione 19.01

  • Richiede NVDA 2018.4 o versioni successive.
  • Migliorata la rapidità di risposta durante il controllo aggiornamenti dei componenti aggiuntivi.
  • Nuove modifiche per una migliore compatibilità con python 3.

Novità nella versione 18.12.2

  • Compatibilità con python 3.
  • Risolto un problema di compatibilità con le versioni Alpha di NVDA, che impediva il download degli aggiornamenti.

Novità nella versione 18.12.1

  • Aggiunte le traduzioni.

Novità nella versione 18.12

  • Possono essere controllati anche gli aggiornamenti dei componenti aggiuntivi disattivati. Tali componenti rimarranno disattivati anche dopo l'aggiornamento.
  • Durante gli aggiornamenti, se un add-on richiede una versione specifica di NVDA e/o di Windows, verrà effettuato un controllo e, se uno dei suddetti requisiti non è soddisfatto, verrà mostrato un messaggio di errore e l'aggiornamento sarà annullato; non vi saranno cambiamenti nella versione degli add-on già installati.
  • Quando il controllo automatico degli aggiornamenti è attivo e gli aggiornamenti sono pronti, verrà visualizzato l'elenco di tutti i componenti da aggiornare invece di chiedere se si desidera controllare gli aggiornamenti.

Novità nella versione 18.10

  • Versione stabile iniziale (da considerarsi ancora sperimentale).